<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
<html>
<head>
<title>PersistentDB</title>
<meta http-equiv="Content-Type" content="text/html;charset=utf-8">

</head>
<body>

<center>
<h1>PersistentDB ReadMe</h1>
</center>

<h2>Contents</h2>
<ul>
<li><a href="#intro">Introduction</a></li>
<li><a href="#systemreqs">Requirements</a></li>
<li><a href="#installationNotes">Installation Notes</a></li>
<li><a href="#thanks">Thanks To</a></li>
</ul>


<a name="intro"><h2>Introduction</h2></a>

<p>Links:</p>
<ul>
<li><a href="http://dev-heaven.net/projects/a2-sql-persistent-db">PersistentDB</a></li>
</ul>

<p>Please note that this is still work in progress. A set of scripts that can be integrated into ArmA2 missions which allow   for persistent player and mission data to be stored in a serverside   database and retrieved on command.</p>

<img src="images/PersistentDB_small.jpg" />


<a name="systemreqs"><h2>Requirements</h2>
</a>
<p><a name="systemreqs">  </a>
  
  To use in a Arma2 mission/script the following must be running serverside. Please note that clients need not run these.</p>
<ul>
<li>Windows Server (Linux not currently supported)</li>
<li><a href="http://www.mysql.com/downloads/" target="_blank">MYSQL</a></li>
<li><a href="http://forums.bistudio.com/showthread.php?131325-Arma2NET&highlight=Arma2NET" target="_blank">Arma2NET</a></li>
<li><a href="https://github.com/firefly2442/Arma2NETMySQLPlugin" target="_blank">Arma2NETMySQLPlugin</a></li>
<li><a href="http://dev-heaven.net/projects/cca" target="_blank">CBA</a> <br>
  </li>
</ul>

<a name="installationNotes"><h2>Installation Notes</h2></a>
<ul>
<li>Download <a href="http://www.kellys-heroes.eu/files/PersistentDB.7z">PersistentDB</a></li>
<li>Install <a href="http://www.arma2.com/beta-patch.php">Arma2 beta version 87640</a> or later, <a href="https://bitbucket.org/Scott_NZ/arma2net/downloads/">Arma2NET</a> and <a href="http://www.microsoft.com/download/en/details.aspx?id=24872">.NET Framework 4 Client Profile</a> on your Windows server.</li>
<li>Install <a href="http://www.mysql.com/downloads">MYSQL</a> and <a href="http://www.mysql.com/downloads/connector/odbc/">MYSQL Connector</a> on your server.</li>
<li>Copy the @Arma2NET folder from the archive to your servers @Arma2NET directory. This contains Firefly's Arma2NET addin for MYSQL.</li>
<li>Extract the .sql files from the dbschema directory, pick one that you feel most comfortable with using to create the database tables and stored procedures.</li>
<li>Extract the database.txt file and write your server's MYSQL connection settings into it and copy it to your server's Arma2 ROOT folder.</li>
<li>Copy the Co18_PDB_ConvoyHell_v1-5-100.Takistan.pbo from the archive's example mpmission/NON ACE/ folder to your server's MPMissions folder.</li>
<li>Create a launch bat file or whatever you use on your server and add the following (you need to do this since at present the addin is not signed) -arma2netdev and mod=expansion\beta;expansion\beta\expansion;@CBA;@CBA_A2;@CBA_OA;@Arma2NET</li>
<li>Launch your server and connect to it with a client. The client does NOT need to run Arma2NET/CBA since all database calls are done by the server.</li>
<li>You do not need jayarma2lib on the server or client for this demo. You can turn PDB ACE support on/off by editing the pdbSetup.sqf: 	pdb_ace_enabled</li>
<li>The mission scripts folder in the archive contains the minimum you need to add to a vanilla MP Arma2 mission to make it PDB.</li>
<li>You can download PDB updates from <a href="https://dev-heaven.net/projects/a2-sql-persistent-db/repository">here</a>  but you'll need to register to access the git repository (you no longer need the Arma2MySQL folder in the repo since that is now legacy i.e old jayarmalib pipe connections) and you can ask questions regarding the demo <a href="http://forums.bistudio.com/showthread.php?111484-ArmA2-Persistent-Database-Scripts-WIP&highlight=PersistentDB">here</a>.</li>
<li>I've left out the www folder from the provided .7z archive. You can grab it from the git archive it you want to. It's not required but contains the webbased php frontend to alter saved PDB data. I'm still developing it so it's pretty rough around the edges at the moment and does not support all features presently. You'll need to be PHP savvy to get it up and running. A tutorial will follow later in it's development.</li>
<li>I had an issue on my Windows server which was resolved <a href="http://forums.bistudio.com/showthread.php?131325-Arma2NET&p=2146134&viewfull=1#post2146134">here</a>.</li>
<li>Copy the MySQL.Data.Dll to the ARMA2, ARMA2Net and Arma2NETMySQLPlugin (to cover all bases!)</li>
</ul>
<a name="thanks"><h2>Thanks To</h2></a>
<ul>
<li>Thank you to Sickboy for all his script mentoring.</li>
<li>firefly2442 for all his C++ programming and addin for ArmA2NET</li>
<li>Scott for programming ArmA2NET and his support.</li>
<li>Thanks to all the <a href="http://www.kellys-heroes.eu" target="_blank">Kelly Heroes</a> testers you beauties!</li>
<li><a href="http://www.bistudio.com" target="_blank">Bohemia Interactive</a> for creating an awesome game and staying true to the community.</li>
</ul>

</body>
</html>
